Query KYC Status

Path

• URL: /cb-core/api/v1/seller/query-status
• Method: POST
• Description: This API allows to query KYC status of a seller

Request

Request Baokim Table

Params	Data Type + Length	Required	Description
request_id	string(50)	Yes	A unique ID for each request from the customer to Baokim
request_time	string(19)	Yes	Time of the request submission.Format: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Yes	Merchant code provided by Baokim
sub_merchant_code	string(20)	Yes	Sub-merchant code. If seller belongs to merchant directly, fill in merchant_code
seller_id	string(50)	Yes	Seller ID in merchant system

Request Example

{
  "request_id": "BK009373788182HUYLLAPU",
  "request_time": "2024-11-01 14:00:00",
  "merchant_code": "MERCHANT001",
  "sub_merchant_code": "MERCHANT001",
  "seller_id": "SELLER123456",
}

Response

Response Table

Params	Data type + length	Required	Description
response_code	int(4)	Yes	Error code from Baokim as per Error Codes Table
response_message	string(100)	Yes	Description of the error code from Baokim as per Error Codes Table
merchant_code	string(20)	Yes	Merchant code
seller_id	string(50)	Yes	Seller ID
status	string(1)	Yes	1: Processing 2: KYC passed 3: KYC failed 4: additional documents required 5: Additional documents have been provided.
reason	string(255)	No	The reason will be available when status = 3 or 4

Response Example

{
    "response_code": 200,
    "response_message": "Success",
    "merchant_code" :"MERCHANT001",
    "seller_id": "SELLER123456",
    "status": 1,
    "reason": ""
}

Error Code

Response Code	Response Message
200	Success
11	Failed
101	System Error
404	Not Found